home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / sound / awemp140.zip / AWEMP.DOC next >
Text File  |  1995-12-20  |  12KB  |  309 lines
  1. -  -  -  - - - --------------------*-*-*-*-*-------------------- - - -  -  -  -
  2.                        Sound Blaster AWE32 Module Player
  3.                          Copyright (C) 1995 by B.Boer
  4.                              All rights reserved
  5.                                  Documentation
  6. -  -  -  - - - --------------------*-*-*-*-*-------------------- - - -  -  -  -
  7.  
  8. Contents:
  9. ---------
  10.  
  11.   1.  What is the Sound Blaster AWE32?
  12.   2.  Is AWEMP freeware?
  13.   3.  How do I use AWEMP?
  14.   4.  Commandline options for AWEMP.
  15.   5.  What keys can I use while AWEMP is playing?
  16.   6.  Features of AWEMP.
  17.   7.  Common Questions and Answers (Q&A).
  18.   8.  Future plans.
  19.   9.  About the author.
  20.  10.  How can I contact the author?
  21.  11.  Where can I get AWEMP?
  22.  12.  I want to be a bèta-tester of AWEMP!
  23.  13.  A final message to all GUS users.
  24.  
  25.  
  26. 1. What is the AWE32?
  27. ---------------------
  28.  
  29. AWEMP is a module player programmed for Creative Labs' Sound Blaster AWE32.
  30. The Sound Blaster AWE32 (for short AWE32) is capable of mixing multiple (max.
  31. 30) channels by hardware, i.e. the EMU8000 chip. The AWE32 has 512 kb onboard
  32. RAM, which you can upgrade to 28 Mb (unless you've got the VE version).
  33. Music sounds very real with this card, because there are two LFO's, two
  34. envelopes and a reverb & chorus effects processor for each of the 30 channels.
  35. With these LFO's and envelopes you can create very special (and natural)
  36. effects to the sound samples, and if you select one of the 16 effect types or
  37. one of the 26 filters, you'll get superb sound!
  38.  
  39.  
  40. 2. Is AWEMP freeware?
  41. ---------------------
  42.  
  43. AWEMP is *cardware*, which means that if you like the program, you must send me
  44. a nice postcard, so I can see how much it is used around the world. See the
  45. section about how to contact the author for the mail address.
  46.  
  47.  
  48. 3. How do I use AWEMP?
  49. ----------------------
  50.  
  51. Well, this is very easy; just type AWEMP [module.ext]. AWEMP will give error
  52. messages (if necessary) in case your module is not supported, or it doesn't
  53. fit into your AWE32's memory (see below), or simply because it couldn't find
  54. your module(s). If there are no error messages, AWEMP will load the samples
  55. into the AWE32 and play the module.
  56.  
  57. For commandline options, type at the DOS prompt: AWEMP /?
  58. While AWEMP is playing, press 'H' to display the helptext.
  59.  
  60.  
  61. 4. Commandline options for AWEMP.
  62. ---------------------------------
  63.  
  64.   /Cxxx  Sets chorus depth, range for xxx is 0-255.
  65.  
  66.   /Exy   Set reverb and chorus effect types, where x is the reverb effect and
  67.          y the chorus effect. Range for both x and y is 1-8;
  68.  
  69.   /I     Ignores all warning messages, that is, they don't appear at all.
  70.  
  71.   /L     Disables module looping, useful when using in combination with option
  72.          '/O'.
  73.  
  74.   /O     Plays the specified modules in a random order. Useful when you
  75.          specify more than one module at the DOS prompt, i.e. AWEMP *.S3M /O.
  76.  
  77.   /Rxxx  Sets reverb depth, range for xxx is 0-255.
  78.  
  79.   /Vxxx  Sets main volume, range for xxx is 0-255.
  80.  
  81.   /X     Don't use expanded memory (EMS). Expanded memory is used for storing
  82.          the patterndata.
  83.  
  84.   /Zx    Set screen size, valid values for x are 0, 1 and 2. 0 = 8 channels
  85.          shown, 1 = 16 channels shown, 2 = auto switch.
  86.  
  87.  
  88. 5. What keys can I use while AWEMP is playing?
  89. ----------------------------------------------
  90.  
  91. Following keys do something useful:
  92.  
  93.        Esc  Stop playing and exit AWEMP.
  94.  
  95.          A  Display the sample names of the current module. Use the cursor
  96.             keys to scroll through the sample names.
  97.          B  Play the previous module in the play list.
  98.          D  Shell to DOS while music keeps playing.
  99.          E  Select reverb and chorus effects.
  100.          H  Display the helptext.
  101.          L  Enter play list, you can then select a module by moving the
  102.             selector bar over a filename and then press the Enter key.
  103.          N  Play the next module in the play list.
  104.          P  Pause the playing of the song.
  105.          Z  Changes between 8 and 16 visual channels displayed.
  106.  
  107.          -  Decrease main volume by 8.
  108.          +  Increase main volume by 8.
  109.  
  110.          [  Decrease reverb depth by 8.
  111.          ]  Increase reverb depth by 8.
  112.  
  113.          {  Decrease chorus depth by 8.
  114.          }  Increase chorus depth by 8.
  115.  
  116.       Left  Decrease song position by one.
  117.      Right  Increase song position by one, at the end of the song, AWEMP jumps
  118.             to position 0 (unless option '/L' is used).
  119.  
  120. While in a DOS-shell you can use these key-combinations:
  121.  
  122.        F11  Pause/unpause playing of the song.
  123.        F12  Stop playing of the song.
  124.  
  125.  SHIFT-F11  Decrease main volume by 8.
  126.  SHIFT-F12  Increase main volume by 8.
  127.  
  128.   CTRL-F11  Decrease song position by one.
  129.   CTRL-F12  Increase song position by one.
  130.  
  131.  
  132. 6. Features of AWEMP.
  133. ---------------------
  134.  
  135. AWEMP is capable of playing the following module formats:
  136.  
  137.  - ProTracker, TakeTracker and FastTracker MODs (up to 32 channels)
  138.  - MultiTracker MTMs (up to 32 channels)
  139.  - ScreamTracker ]I[ S3Ms (up to 32 channels)
  140.  
  141. All effects are implemented except for the set glissando control (E3x) effect.
  142.  
  143. Effects supported:          0xy - arpeggio
  144.                             1xx - portamento up
  145.                             2xx - portamento down
  146.                             3xx - portamento to note
  147.                             4xy - vibrato
  148.                             5xx - tone portamento + volume slide
  149.                             6xx - vibrato + volume slide
  150.                             7xy - tremolo
  151.                             8xx - set pan position
  152.                             9xx - sample offset
  153.                             Axy - volume slide up/down
  154.                             Bxx - position jump
  155.                             Cxx - set volume
  156.                             Dxx - pattern break
  157.                             E1x - fine portamento up
  158.                             E2x - fine portamento down
  159.                             E4x - set vibrato waveform
  160.                             E5x - set looppoint
  161.                             E6x - jump to looppoint
  162.                             E7x - set tremolo waveform
  163.                             E8x - set pan position
  164.                             E9x - retrig note
  165.                             EAx - fine volume slide up
  166.                             EBx - fine volume slide down
  167.                             ECx - note cut
  168.                             EDx - note delay
  169.                             EEx - pattern delay
  170.                             Fxx - set speed/bpm
  171.                             Rxy - multi retrig note
  172.                             Txy - tremor
  173.                             Uxy - fine vibrato
  174.                             X1x - extra fine portamento up
  175.                             X2x - extra fine portamento down
  176.  
  177.  
  178. 7. Common Questions and Answers (Q&A).
  179. --------------------------------------
  180.  
  181. Q: You said that 15-instruments MODs are supported, but AWEMP won't load my
  182.    MOD!!
  183.  
  184. A: AWEMP checks the module if it has some sort of identification (such as M.K.
  185.    or FLT8), if it hasn't, AWEMP assumes it's a 15-instruments MOD. Before
  186.    AWEMP loads the samples, a small check is processed on the module to see
  187.    whether it's a real 15-instruments MOD or not. AWEMP does this by comparing
  188.    the filesize with the total sum of <patterndata-offset + patterndatasize +
  189.    sampledatasize>. If this is not equal, the module will be discarded.
  190.  
  191. Q: I've got an AWE32 with 8 Mb onboard, but AWEMP tells me that there's only
  192.    512 kb onboard.
  193.  
  194. A: There is only one possible reason that AWEMP detects only 512kb: you did
  195.    forget to remove jumper JP7 on the card, which is necessary to use the SIMM
  196.    banks. See also the manual which came with your card.
  197.  
  198. Q: What about all those clicks? It sounds just like I'm listening to an old
  199.    gramophone.
  200.  
  201. A: Because of the high frequency rate (44.1 khz, 16 bit) the AWE32 is playing,
  202.    you will hear every small detail of the samples played. Because the AWE32
  203.    only accepts 16 bit samples, AWEMP must convert the 8 bit samples used in
  204.    MODs to 16 bit samples. The clicks you hear, are probably caused by badly
  205.    set looppoints. In the future I will use sample smoothing, so those clicks
  206.    will be gone.
  207.  
  208. Q: When will AWEMP support XMs?
  209.  
  210. A: XMs will be supported in one of the following versions of AWEMP.
  211.  
  212.  
  213. 8. Future plans.
  214. ----------------
  215.  
  216. Well, I decided to put in this subject because many people asked me what I'm
  217. intended to do next. I'm either working on one of the following things or just
  218. dreaming of having them implemented :)
  219.  
  220.  * File browser/selector for creating your own playlist within AWEMP.
  221.  * XM support, volume and panning envelopes are quite a bit tricky, but XM
  222.    support *will* be implemented somewhere in the future.
  223.  * Graphical user-interface, mode will be 640x480x16c or 640x480x256c.
  224.  
  225.  
  226. 9. About the author.
  227. --------------------
  228.  
  229. I am 17 years old and I attend the sixth class of a secondary school. I live
  230. in the Netherlands, also known as Holland.
  231.  
  232. This program is my first real try to make a modplayer. I know it isn't perfect
  233. yet, but it already sounds very nice. The future of this program depends on
  234. how much reply I get and the difficulties I will encounter when implementing
  235. new effects or improving the player.
  236.  
  237. Big thanks to:  - Klaasjan Brand, for his marvelous 386 machine ;-)
  238.                 - Gerard Veldman, for helping me out with coding troubles.
  239.                 - Jean-Paul Mikkers, for his *great* frequency calculation
  240.                   routine. AWEMP v1.40 wouldn't ever be released, if he
  241.                   didn't help me out.
  242.                 - Vince Vu, for sharing some thoughts about the AWE32.
  243.                 - ...and you, for reading this doc!
  244.  
  245.  
  246. 10. How can I contact the author?
  247. ---------------------------------
  248.  
  249. If you experience problems when using AWEMP, or you have found bugs, or you
  250. have some very nice ideas, or you know how to implement new effects, or
  251. something else I should know, write to me:
  252.  
  253. Mail address : Bert Boer
  254.                Schapendrift 30
  255.                8091 GW  Wezep
  256.                The Netherlands
  257.  
  258. Netmail      : 15:1100/400 (Fido NL)
  259.  
  260. Internet     : trigon@ddu.iwg.nl
  261.  
  262. Remember, AWEMP is cardware, so if you haven't sent your postcard yet, please
  263. send one now. As soon as I receive your card (e-mail will do too), your name
  264. will be added to the people-who-encouraged-me list (see the file SUPPORT.ERS).
  265.  
  266.  
  267. 11. Where can I get AWEMP?
  268. --------------------------
  269.  
  270. AWEMP is spread across the world via the SDC, this net covers almost every
  271. country in the world. In case there isn't any board in your country which has
  272. access to SDC, you can always get the latest version of AWEMP on these boards:
  273.  
  274.   Sound Distribution Channel (SDC) Dutch HQ
  275.   TH Rijswijk (THR)
  276.   +31(0)70-3401534   (speeds up to 28k8 V.34/V.FC)
  277.  
  278.   DoomDark Universe (DDU)
  279.   +31(0)38-4600611   (speeds up to 33k6 V.Everything)
  280.  
  281. The filename of the archive looks like this: AWEMPxyy.RAR or AWEMPxyy.ZIP,
  282. where x is the major and yy the minor version number, e.g. AWEMP131.RAR is
  283. the archive of AWEMP version 1.31.
  284.  
  285. On DDU you can get AWEMP very easily; just type in when asked for name: AWEMP,
  286. select language and the latest release of AWEMP can be downloaded immediately.
  287.  
  288.  
  289. 12. I want to be a bèta-tester of AWEMP!
  290. ----------------------------------------
  291.  
  292. If you want to become a bèta-tester, just mail me and I will decide whether
  293. you become a tester or not (telling me some interesting things will usually do
  294. the trick). Then I will give you access to an area on DDU (the BBS mentioned
  295. above) which is reserved for AWEMP bèta-testers. Here you can get the newest
  296. (bèta)version of AWEMP. To be a bèta-tester does not only mean testing but also
  297. giving your opinions/experiences/troubles with new versions . . .
  298.  
  299.  
  300. 13. A final message to all GUS users.
  301. -------------------------------------
  302.  
  303. I removed this subject because it seemed that nobody (read: GUS users) would
  304. ever read this piece of text. If you think you've got a nice idea/subject I
  305. should put in here, let me know!
  306.  
  307.  
  308. -  -  -  - - - --------------------*-*-*-*-*-------------------- - - -  -  -  -
  309.